home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 11 / AMUG BBS in a Box Volume XI (April 1994) (MacWizards).iso / Files / Tele / Internet / UUPC 3.1b25.sit / Documentation / UUPC 3.0 Systems file format < prev   
Encoding:
Text File  |  1992-10-31  |  9.2 KB  |  185 lines  |  [TEXT/ALFA]
  1.  
  2. uupc 3.0 Systems file
  3.  
  4. This file must contain one line or more entries for each system that
  5. you wish to call.  If there are other systems which will be calling
  6. you, but which you will not be calling, then you must also have lines
  7. in this file for them (one each)... or you can have an ANONYMOUS
  8. line to permit any uucp system in the world to call you.
  9.  
  10. The general format of the lines in this file is:
  11.  
  12.   name time port dialer speed phone protocol expect send expect send ...
  13.  
  14. where:
  15.  
  16.  name      is the uucp name of a system which you will be calling, or
  17.            will be calling you.  The first seven characters are
  18.            significant.  There are two special reserved names...
  19.            INCOMING is used to specify the port configuration to be
  20.            used when answering incoming phone calls, and ANONYMOUS
  21.            is used to specify that anonymous access is to be permitted
  22.            (i.e., your system will accept an inbound uucp call from any
  23.            uucp node anywhere).
  24.  
  25.  time      is the times of day during which your system is permitted to
  26.            place a phone call using the information on this line (or, in
  27.            the case of the INCOMING entry, to accept phone calls using
  28.            the information in this line).
  29.  
  30.      acceptable formats:  "Any", "Evening", "Night", "hhmm-hhmm"
  31.      hhmm-hhmm may be a inclusive range, ie: 0000-0600,
  32.      or it can be an range that specifies morning and evening hours,
  33.      ie: 1700-0700 (means 0000-0700 and 1700-2359)
  34.  
  35.      "Night" includes the standard AT&T night rate hours from 2300 to
  36.      0800 plus Friday evening, all day Saturday and Sunday until 1700.  
  37.  
  38.      "Evening" include the standard AT&T evening and night rate hours.  This
  39.      includes all hours except 0800-1700 Monday thru Friday.
  40.  
  41.      Time may also include a retry interval (e.g. "evening;10") to specify
  42.      the minimum retry interval.  If a retry interval is specified, it will
  43.      be used precisely as given.  If no retry interval is specified, a
  44.      HoneyDanBer-style exponential backoff algorithm is used... the retry
  45.      time will be 5 minutes after the first failed attempt, 10 minutes after
  46.      the second, 20 after the third, and so forth... up to a maximum backoff
  47.      of 23 hours.
  48.  
  49.  port      specifies which serial port should be used.  'a' is the modem
  50.            port, and 'b' is the printer port.  If you have additional
  51.            serial ports with standard "shadow" drivers... if they can be
  52.            accessed as devices ".Cin" and ".Cout", ".Din" and ".Dout",
  53.            etc... then you can specify such ports as 'c', 'd', and so on
  54.            through 'd'.  Sorry, no Communications Toolbox support yet.
  55.  
  56.  dialer    specifies the autodialing method to use.  DIR means "direct
  57.            connect";  it can be used when your Mac is directly connected to
  58.            another system, and can also be used to issue dialing commands
  59.            to a nonstandard modem.  HAYES means "Hayes-compatible modem";
  60.            you may specify "HAYES+string" to specify additional options
  61.            to be sent to the modem during the handshaking sequence (e.g.
  62.            setting S-registers), or "HAYES!string" to specify options and
  63.            to tell the dialer to ignore the speed returned in the CONNECT
  64.            message (i.e. "lock" the Mac-to-modem speed).  VADIC means
  65.            "Racal-Vadic VS212P modem"... does anybody else actually own
  66.            one of these?
  67.  
  68.  speed     specifies the bit rate at which the serial port should be
  69.            configured.  The standard port rates are supported, up to
  70.            57600 bps.
  71.  
  72.  phone     specifies the phone number to be dialed.  It can be a simple
  73.            string of digits (the Hayes dialer will prepend 'DT' to it),
  74.            or a complex string of modem options and digits (in whcih case
  75.            you must include a 'D' or 'DP' or 'DT' to start the dialing)
  76.            or a '-' character which means "none".  The '-' form will usually
  77.            be used with a DIR connection, or in the specification of an
  78.            INCOMING call.
  79.  
  80.  protocol  specifies the uucp protocol which should be used.  The usual
  81.            protocol is 'g'... uupc 3.0 defaults to a 3-packet window, and will
  82.            negotiate down to a smaller window based on its peer's advertised
  83.            maximum window size.
  84.  
  85.            You may also specify 'g' with a larger window size... e.g  'g7'...
  86.            if your peer supports a larger window and can actually handle
  87.            it properly.  Some systems will negotiate a 7-packet window, but
  88.            can't really support it (e.g. at 9600 bps, Ultrix drops packets in
  89.            a 7-packet window but handles them fine if the window is limited
  90.            to 3 packets).
  91.            
  92.            You may also change the packet size used by the 'g' protocol, from
  93.            its normal value of 64 bytes to either 128 or 256 bytes.  Very
  94.            few uucp implementations will agree to receive larger packets
  95.            from uupc.  A few can send 128-byte packets, even if they cannot
  96.            accept them in return, but will fail if you ask them to send you
  97.            256-byte packets.  To specify an alternate packet size, you must
  98.            specify both the window size and packet size... e.g. 'g3/128'.
  99.  
  100.            The 'f' protocol is also supported.  This is a streaming
  101.            protocol, designed to operate over nearly-error-free, flow-
  102.            controlled, 7-bit-wide data links... specifically, over X.25
  103.            packet-switched networks via an X.25 PAD.  It can also be used
  104.            over modems which support MNP (level 3 or 4) or V.42.  It works
  105.            very nicely over MNP 5 and V.42bis modems with data compression.
  106.            Not many uucp implementation support the 'f' protocol (it's a
  107.            BSD-ism).
  108.  
  109.  send      represents a string to send.  A carriage return is automatically
  110.            appended, unless a \c sequence appears within the string.
  111.  
  112.  expect    represents a string to expect (wait for). Try-again sequences are
  113.            specified with hyphens... e.g. A-xxx-B means "wait for A, if
  114.            you don't see it within the timeout interval, send xxx and then
  115.            wait for B".
  116.  
  117. You may have two or more lines in the Systems file for any uucp
  118. system-name.  The lines may specify different calling times, ports,
  119. dialers, speeds, protocols, and send/expect sequence.  When uupc 3.0
  120. attempts to place a call to your neighbor, it will try the lines one
  121. after another until it [a] finds a line that it can use at the current
  122. time and [b] places a successful call to the neighbor.
  123.  
  124. If you have more than one line in the Systems file for a neighboring
  125. site, put all of these lines together... don't intersperse lines which
  126. apply to other systems.  If you do, uupc 3.0 will sometimes call the
  127. neighbor more than once in a single processing run.
  128.  
  129. The send and expect strings both permit the use of escape sequences of
  130. various sorts.  The following escapes can be used in the "expect" strings:
  131.  
  132.     \r - expect a carriage return
  133.     \n - expect a newline
  134.     \t - expect a tab
  135.     \  - (backslash space) - expect a space
  136.     \\ - expect a backslash
  137.     \x - where "x" is not one of the above - expect "x" itself.
  138.     
  139.     •  - (option-8) - end of "expect" string, beginning of "don't expect"
  140.          string.  If the string which follows the • character should appear
  141.          before the string which preceeds it, abort the call attempt
  142.          immediately.  Multiple don't-expect strings can be used, separated
  143.          by • characters.
  144.  
  145. The following escapes can be used in the "send" strings:
  146.  
  147.     \d or \D - delay two seconds
  148.     \r or \R - send a carriage return
  149.     \m or \M - send a carriage return
  150.     \n or \N - send a newline
  151.     \t or \T - send a tab
  152.     \s or \S - send a space
  153.     \c or \C - do NOT append a carriage-return to the end of the string
  154.     \p or \P - pace the remainder of the string - send at a rate of
  155.                roughly 15 characters per second
  156.     \#       - where # is a decimal number - change the expect-string
  157.                timeout to the specified number of seconds
  158.     \Z#\     - where # is a decimal number - change the serial-port
  159.                baud rate to the specified number.
  160.     \\       - send a backslash
  161.     ^x       - where "x" is an ASCII character... send a control-x
  162.     \^       - send a ^ character
  163.  
  164. There are several special "send" strings
  165.  
  166.     BREAK    - send a 300-millisecond "break" signal (a "long space")
  167.     BREAKn   - where 'n' is a digit between 1 and 9 - sent an n-hundred-
  168.                millisecond long space (e.g. BREAK6 sends a 600-millisecond
  169.                break signal)
  170.     P_EVEN   - switch the connection to 7 data bits, even parity
  171.     P_ODD    - switch the connection to 7 data bits, odd parity
  172.     P_NONE   - switch the connection to 8 data bits, no parity
  173.  
  174. The INCOMING entry is treated somewhat specially.  If the HAYES dialer is
  175. specified, it is called and instructed to configure the modem to allow
  176. incoming phone calls to be answered, and to wait for such a call-and-answer
  177. sequence to occur.  After the dialer detects an answer (or immediately, if
  178. the HAYES dialer is not used), the chat script is executed.  Finally, a
  179. pseudo-login shell is run... it prompts the caller for a "Username:", and
  180. then a "Password:".  The password must match the contents of the PASSWORD
  181. configuration string... if it does, the username is displayed on the
  182. uucp console window, and protocol startup is performed.  If an incorrect
  183. password is entered, it is rejected and the caller is prompted for the
  184. username once again.
  185.